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by invoking the dispatching member function of the event 
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member function invokes the identified member function of 
the identified target object passing the event information as 
an acmal parameter. The event object is preferably of a 
derived class that inherits a base dass. The base class 
provides coimnon event behavior, while the derived class 
provides behavior specific to a type of message. 
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SYSTEM FOR INTERCONNECTING 
SOFTWARE COMPONENTS IN AN OBJECT 
ORIENTED PROGRAMMING 
ENVIRONMENT USING A SEPARATE 
EDITOR OBJECT FOR EACH RUN TIME 
OBJECT INSTANTIATED FOR EACH 
SELECTED COMPONENT 

GROSS-REFERENOE TO RELATED 
APPUCATION 

Hiis application is a division of U.S. patent application 
Ser. No. 08/153362. filed Nov. 16, 1993. 

TECHNICAL FIELD 

The present invention relates generally to a computer 
system foa- visual programming, and more specifically, to a 
method and system for interconnecting visual components 
and passing messages between connected components. 

BACKGROUND OF THE INVENTION 

Visual programming is a computer programming tech- 
nique that allows for rapid development of visually oriented 
programs (visual programs). FIG. 1 is a diagram illustrating 
a sample operation of a visual progranL The visual program 
is a temperature converter, which converts Fahrenheit to 
Centigrade, and vice versa. The Fahrenheit scroll bar 101 is 
used to set the Fahrenheit value to between 0 and 100 
degrees as indicated by the position of the Fahrenheit slider 
103. The Fahrenheit display 102 displays the numeric Fahr- 
enheit value represented by the position of the Fahrenheit 
slider. The Centigrade scroll bar 111 is used to set the 
Centigrade value between 0 and 100 degrees as indicated by 
the Centigrade slider 113. The Centigrade display 112 dis- 
plays the numeric Centigrade value represented by the 
position of the Centigrade slider. In operation, when the 
Fahrenheit slider is moved by a user, the Centigrade slider 
is autonjatically moved to the corresponding Centigrade 
position and the Fahrenheit and Centigrade displays are 
updated. Conversely, when the Centigrade slidex is moved 
by a user, the Fahrenheit slider is automatically moved to the 
corresponding Fahrenheit position and the Centigrade and 
Fahrenheit displays are updated. 

Visual programming allows various components (e.g., a 
scroll bar) to be interconnected visually to effect the program 
bdiavior. A visual programming environment typically 
includes a list of predefined components that can be inter- 
connected to create a visual prograno. Each component may 
include input and ou^ut ports and a visual interface. When 
creating a visual program, a programme specifies the visual 
components and their location on the display. The program- 
mex also specifies the interconnection between various ports. 
Hie components pass values through these coimections. 
FIG. 2 is a block diagram illustrating a scroll bar con4X)nent 
Hie scroll bar con^nent 201 receives messages from the 
operating system (e.g.. mouse down) and controls the dis- 
play of a scroll bar. The scroll bar also provides an input port 
203 and an output pon 202. The input poit is used to receive 
a value indicating a new position of the slider and the ouQ)ut 
port is used to send a value indicating a new sUder position. 
The scroll bar can be connected to other conq)onents 
through its ports. 

FIG. 3 is a diagram illustrating a scroll bar connected to 
a display component A display component 301 has one 
input port 303 for receiving a value. The display continent 
controls the displaying of the value that it receives. The 



2 

ou^ut port 202 of the scroll bar component 201 is connected 
to lie input port 303 of the display component. In operation, 
whenever the scroll bar slider is moved, a value indicating 
the new position of the slido* is sent from the scroll bar 
5 component to the display conqwnent The display compo- 
nent receives this value and updates its display accordingly. 

Although prior references have described general visual 
programming environments, visual programming is not 
widespread because of the inefficiencies of visual programs. 
10 For example, visual programs often execute in an interpre- 
tive mode that results in unacccptably slow performance. 

SUMMARY OF THE INVENTION 

It is an obj ect of the present invention to provide a mediod 
and system tfiat allows for creation of efBdent visual pro- 
grams. 

It is another object of the present invention to provide a 
method and system that shields component developer from 

20 the details of the connecting of con:qx>nents and Ac passing 
of values between components. 

These and other objects, which will become apparent as 
the invention is more fully described below, are obtained by 
an improved method and system for sending messages 

25 between components. In a preferred embodiment, the 
present invention instantiates an event object The event 
object includes message information describing the message 
and a dispatching member function for invoking a member 
function of a target object passing the message information. 

30 A message is passed by invoking the dispatching member 
function of the event object passing an identifier to a target 
object and an identifier of a member function of the target 
object. The dispatching member function invokes the iden- 
tified member fiinction of the identified target object passing 

35 the event infOTmation as an actual parameter. TTie event 
object is preferably of a derived dass that inherits a base 
class. The base class provides common event bdiavior, 
while the derived dass provides behavior specific to a type 
of message. 

40 

BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 is a diagram illustrating a sample operation of a 
visual program 

FIG. 2 is a block diagram illustrating a scroll bar com- 
ponent 

KIG. 3 is a diagram illustrating a scroll bar connected to 
a display con^nent 

FIG. 4 is a diagram illustrating visual programming of the 
50 present invention. 

FIG. 5 is a diagram illustrating the instantiated objects for 
the tenq)erature converter. 

FIG. 6 is a table containing a listing of the connec^ons for 
the for the tenqxcrature converter program. 

FIG. 7 is a flow diagram illustrating the flow of control of 
sending a message from a source object to a target d)ject 

FIG. 8 is a block diagram of data structures of a CEditor 
object. 

60 FIG. 9 is a block diagram of a con5)uter system. 

DETAILED DESCRffTION OF THE 
INVENTION 

The present invention provides a method and syston for 
65 connecting components and passing of messages (events) 
between con^nents. In a preferred embodiment each 
conq>onent may provide irmltiple input ports and output 
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pQits. Badi output port sends a message canespoading to a to an input port that expects a message in the same fonnat 

particular type of event; each input port receives a message as a scroll up message, 

conesponding to a paitieular type of event A component ^ souiee object (coircsponding to a source component) 

that sends a message is referred to as a source, and a a message («Uminicates the occuirence of anevent 

«,mponent that recavestte message js referred to as the 5 by invoking % member function of a target oS 

target In a preferred enibodmient, each component has an / .° a m^uiu^ xuuk.klxju ui « uugci uujcci 

associated nm-time dass and editor class. ThTeditor class (^=°^^ding to a target component). Each mput and 

provides component-specific behavior to assist in creating a ^"^"t P<«.^ preferably associated wtth a function member 

visual program. The run-time class provides the component f ^'^^ ""^^^^ ^^f^ \ ''=^^ "^^^^ 

behavior when the visual program executes. A visual prc^ ,o <^^^?^'i^^X^"^^~^ 

gramming system controls the development of visual prcv "^P«t port f^receivmg a new value and a ftmction member 

grams by instantiating objects of the editor classes and earned VdueOutcorrespon<^g to an ou^ut port for s(^^ 

controls the run-time execution by instantiating objects of ^ f""?; ^ ^P^;^^- the m«nber function ValueOut is 

tiierun-timeclass.Asdescribedbelow,theprcsentinvention ^^^^ whenever a change in the value for the scroll bar 

provides a mechanism in which messages are effidentiy ^ccurs e.g., when tbe shdcr is moved m 

passed between components. In the foUowing, a preferred ValueOmmvokes the target member function corresp^^ 

embodiment of die present invention is described using "^P/" ^ connected. The invoked 

weU-known object-oriented terminology and terminology of t^^t member toction then processes the value information 

tiie C++ programming language. which is passed as a parameter. 

HG. 4 is a diagram lUustrating visual programming of the 20 ^ ^ preferred embodiment, message information (e.g., 

present invention. To generate a visual program to imple- encapsulated in an object of an event class, 

ment a temperature converter, a programmer would position member function corresponding to an output port 

a Fahrenheit scroll bar 401, a Fahrenheit display 430, a ^eates an event object and stores die event information in 

Centigrade scroll bar 420, and a Centigrade display 440. The ^"^^^^ object The source memba: function effects the 

programmer would also position an FtoC calculator 460, 25 ^ notify member function of a target object 

which converts a Fahrenheit value to a Centigrade value, and Passing the event object and a pointer to the target member 

a CtoF calculator 450, which converts a Centigrade value to function. The notify member function invokes a dispatching 

a FahrenheU value. In one embodiment tiie components are nieraber function of the event object passing a pointer to tiie 

selected from an extendible list of available components. target object and a pointer to the target member function. 

The programmer then connects the components tiirough 30 dispatching member function invokes tiie target mem- 

tiieir ports. The connections 412->461 and 412-*431 indi- function passing the stored information as a parameter, 

cate that when tiie Fahrenheit scroll bar is dianged (e.g., ^ ^ preferred embodiment, different inqilementations of 

sUder moved), tiie new value is sent to tiie FtoC calculator ^^^"^^ ohjot^ are used to represent different function proto- 

and tiie Fahrenheit display. The connection 462-^421 indi- ^^P^® (parameter list) of target member functions. Eadi dass 

cates tiiat when tiie FtoC calculator calculates a new Cen- 35 of event object contains information tiiat is passed to a target 

tigrade vahie, tiie new value is sent to tiie Centigrade scroU n^ember function according to tiie function iffototype. Thus, 

bar. The connections 422->441 and 422-^1 indicate tiiat source member function invokes target member func- 

when tiie Centigrade scroll bar is changed, tiie new value is ^^^^ prototype. 

sent to the QoF calculator and the Centigrade display. The In a prefored embodiment eadi run-time dass inherits 

connection 452->411 indicates that when the QoF calcula- 40 the dass CObject The class CObject tracks the coxmections 

tor calculates a new Fahrenheit value, the new value is sent controls the sending of messages. The class CObjed: is 

to the Fahrenheit scroll bar. In one embodiment the com- referred to as a connection manager. In this way, run-time 

ponents are connected by entering a connect mode and classes that implement component bdiavior can be devel- 

selecting the source and target of eadi connection. opGd wiUiout detailed knowledge of the implementation of 

The visual programming system instantiates an object of 45 CObject Moreover, run-time objects implemented 

tiie lun-time class for each con:q)onent selected by the by different developers can coq)erativdy interact FIG. 6 is 

programmer. FIG. 5 is a diagram illustrating the instantiated ^ containing a listing of the connections for the for the 

objects for tiie temperature converter. The FScrollbar object temperature converter program. The dass CObject indudes 

501 ccffresponds to the Fahrenheit scroll bar component tiie ^ (connectionAcray) that contains the connections for 

CScrollbar object 502 corresponds to tiie Centigrade scroll 50 ou^i port of tiie run-time object Each entry of tiie 

bar con^nent, tiie FDisplay object 503 COTresponds to the connection array contains an identifier of the output port of 

Fahrenheit display component the CDisplay object 504 source object, an identifier of the targ^ object, and an 

corresponds to tiie Centigrade display component, tiic FtoC identifier of the input port of the target object For example, 

object 505 corresponds to tiie FtoC calculator component ^e connection array for tiie FSaollbar object contains two 

and tiie QoF object 506 corresponds to tiie QoF calculatw 55 entries: 

component Eadi of tiiese objects implements flie display ^ .„ , ,^ , ^ 
and control of tiie corresponding component. The dire^d ^"^^ ^> ^> 
arcs indicate tfie direction of tiie connections, tiiat is, from an "Oua** identifies tiie oulput port, "FDisplay" and TtoC 
output port to an input port identify die target objects, and 'InP identifies the input port 
Each component may send messages to otiier components 60 of the target objects. When an event occurs for a particular 
corresponding to different types of events. For exan^le, a output port, the source object instantiates an event object and 
scroll bar may send a message to indicate a changed value invokes an inform targets member function of the dass 
event has ocanred and another message to indicate a scroll CObje<^ (connection managa-) identifying tiie output port 
down hat occurred. Eadi type of event has its own output The on^ut port is preferably identified by a pointer to a 
port. Also, input poiu are designated to rccdve only cotain 65 member func^on (source member function) of tiie source 
types of events. For cxanqile, an output port tiiat sends object The inform targets member function sends an appro- 
messages relating to a scroll up event can only be connected priate message to each target object as indicated by the 
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connection array for the source object The input port is 
jrcferably identified by a pointer to a member function 
(target member function) of the target object The connec- 
tion manager sends the niessage to the target object by 
invoking a notify member fundion of the target object 
passing a pointer to the target member function and an event 
object The event object contains actual parameters for the 
target member function. The notify member function 
invokes a dispatch member function of the event object 
passing a pointer to the target member function and a pointer 
to the target object. The dispatch member function formats 
the acmal parameters and invokes the target member func- 
tion of the target object passing the actual parameters. 
Code Table 1 contains pseudocode for the class CObject 



6 

Target adds an entry to the connectionArray of the source 
object corresponding to the passed parameters. In a preferred 
embodiment the connections are stored not as data members 
of the CObject but rather are stc^ in a heap that is shared 

5 by all run-time objects. In this way. the storage overhead for 
each object can be minimized. 

A message is sent to a target object in the following 
manner. The source object instantiates an event object and 
stores event infcnnation in the event object The source 

10 object invokes the member function InformTargets of its 
connection manager passing the event object and a pointer 
to the source member function. For each connection for that 
output port (source member function), the connection man- 
ager invokes the member function NotifyEvent of target 



Code TABLE 1 



class CONNECnON 
{CObject *ptargct; 

ULONG pmftarget; 

ULONG pmfsouicc; 

} 

class CObject 
{ 

boolean isReoirsiitg; 
CONNECnON conncctionAnayllO]; 
izit comiectianCouQt; 

virtual boolean Notif]^vent (CEvcnt *pevcnt, CObject *psouicc, ULONG pmftaiget); 

boolean lQfQnnTargets(CEvent *pevent, ULONG pm&ouice); 

void AddTarget(CObject *ptaiget» ULONG pmftaiget, XJLONG pmfsource); 
virtual void Serialize(CArchive &ar); 
virtual VOID WrilBConnectionAiTay(CArchive &ar); 
virtual VOID ReadConncctionAiTay(CATchive &ar); 
virtual VOID SerializeObjectData(CAichivc &ar), 

}; 

BOOL CObjcct::NodfyEvcnt (CEvent Tpcvent, CObject ♦psource^ ULONG pmftaiget) 
{ 

BOOL ret, 

if (isRecursing) return EAT^SR; 

isRecursing = TRUE: 

if (pcvcnl -22 IsKiiiciOf(CVilueEveat)) 

ret — ((C\^ueEvcnt*)pcveiit)->Dispateh(psourcev this, pmftarget); 
else if 



else return FALSE; 
isRecursiDg- FALSE; 
return ret; 

} 

BOOL CObjcct::IafbrmTargcts(CEvenl •pevent, ULONG pmfeourcc) 
{ 

fioT(i = 0; i < conuectioDCount; 
{ 

if (ooQnfictioQAiray[t].pni£9ouice — pm&ource) 
conaectiDnAiray[i).pnifiargiet->NolifyEveat(pevent, this, 
canoecttoxiArray[i].pinftai]^t); 
> 

} 

void C0b3cct:.Ackrraigct(C0b)ect •ptaiget, ULONG pinftarget,ULONG pnxfaource) 
\ 

i = connectionCount-H-; 
connectionAjTaylij.ptarget = ptaiget; 
oanDect2onAjray[ iJ.pioCtaiget = pmfiaiget; 
oonnectioQArTayiij^mifsource = pis£source; 

} 



The programming system adds connections to a run-time 
object by invoking the member function AddTarget provided 
by the connection manager. The programming system 
invokes the AddT^ct membo^ function of the source object 
whenever a programmer connects two c^jects. The men^ber 
function Ad^Target is passed a pointer to the targ^ object, 
a pointer to the target member function (rqjresenting the 
input port), and a pointer to a source member function 
(representing the output port). The member function Add- 



object passing tlie event object, a pointer to the target 
member function, and a pointer to the source object The 
member function NotifyEvent invokes &e member function 
Dispatch of the event dbjcct passing a pointer to the source 
object, a pointer to the target object, and a pointer to the 
target member function. The member function Dispatdi 
invokes the target member function of the target object 
passing the stored event information as actual paramos. 
An event object enc^sulates the message information in a 
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way that is transparent to the connection manager. Thus, the event dass can have a data meniber for the integer and 

connection manager can control the invoking of target another for the string. The menober function Dispatch of the 

member fiinctions passing arbitrary panuMters. ^y^^ ^lass invokes a passed targrt member function passing 

FIG. 7 is a flow diagram illustrating the flow of control of ... ^ j *u -L * 

sending a message fi^ a source object to a taiget object. A j integer and the stnng as parameters, 

source member function 710-714 of the source object Code l^le 2 contains pseudocode that describes the 

instantiates an event objta in step 711. In step 712, the event classes. Each event dass derives from the dass 

source member function stores the event information in the CEvent. The event dass CIntEvent is used to pass informa- 

event object In step 713. the source membo- function tion stored as an integer to a target member function. The 

invokes the niember function InformTargets of the conncc- lo member function Dispatch is passed a pointer the target 

tion manager passing a pointer to the event and the source object and a pointer to the member function. TTie member 

member function. Jn step 721. the meinber function function Dispatdi invokes the targetmemberfimction by the 

InformTargets loops deteimimng which entnes in the con- foUowine statement* 
nection array correspond to the source member function. 

When an entry is found, the member function InfonnTaigets x5 

invokes the member function NotifyEvent of the target (ptargct->*(i^TbMembcr(pmftaigct))Xi^ 
object passing a pointer to the event, a pointer to the source 

object and a pointer to the target member functioD. In step The event dass CActionEvent is used to pass messages with 

731, the member function NotifyEvent of the target object no corresponding data, and the event class CStringEvent is 

invokes the member function Dispatch of the event passing used to pass messages with string data. 



class CEvcnt 
{ 

public: 
CEvcntO; 

virtual BOOL Dispatch (CObject *psourcc, CObject •ptaiget, ULONG pmftaisct)= 0; 

} 

class CAcdonEveat: public CEvent 
{ 

public: 

virtual BOOL Dispatch (CObject *psouice, CObject *ptaiget, ULONG pmftaigct) 
{(ptaiget.>*(LongToMcmber(pmf)))0}; 

} 

class CINtEvent: public CEvent 
{ 

public: 
INTnumVahie; 

virtual BOOL Dispatch (CObjcct*psouicc, CObject *ptaixet, XILONG pmftaigel) 
{(ptaiset- >*CLjOQg'IbMembei^mftaiset)))(numVahie)}; 

} 

class CStringEvent public CEvent 
{ 

public: 
STRING stringVahie; 

virtual BOOL Dispatch (CObject •psomce, CObject •ptaiget, ULONG pmfiaigct); 
{(ptaTgct->*(LongToMember(pmflaiget))XstringVahje)}; 

} 



a pointer to the source object, a pointer to the target object, 
and pointer to the target member function. In step 741, the 
member function Dispatch invokes the target member func- 
tion passing the event information stored in the event object 
The target member function processes the event information 
in step 751. The target member function then returns, which 
causes the member functions Dispatch, NotifyEvent and 
InformTargets to return to the execution of the source 
member function. 

The use of an event object allows the connection managa* 
to invoke input member functions with arbitrary parameters. 
Each prototype for a input member function has its own 
implementation of the event class to handle the event The 
source object instantiates the appropriate dass of event 
object For example, the input member function Valuein is 
passed an integer. Thus, an event class is inqilemented that 
contains an integer data member to store the value. The 
member function Dispatch of the event dass invokes a 
passed target member fimrtion passing the stored value. An 
event class may be implemented for each different prototype 
of a target membs- function. For example, if the event 
information includes both an integer and a string, then an 



45 

Code Table 3 contains pseudocode for a sanqile scroll bar 
object corresponding to a scroll bar component The scroll 
bar object is defined by dass CSaollbar, which inherits the 
connection manager (class CObject). The dass contains data 

50 members to store the current value of the scroll bar, a large 
and small increment for the scroll bar. and the minirmim and 
maximum values for the scroll bar. The dass also contains 
the member function to set and retrieve the current value, to 
receive messages from the parent window of that scroll bar, 

55 and to effect various scroll bar behavicss. The scroll bar 
component has an input function member (value) with one 
parameter and an output function member (value) with no 
parameters. 

The constructor CScrolIbar registers the scroll bar with 
60 the operating system and initializes its data members. The 
member function HandleParentMsg receives messages firom 
the parent window and dispatches the message. For 
example, if the member function HandleParentMsg is 
passed a message that the scroll bar event line up (SB_ 
65 LINEUP) has occurred, then the member function invokes 
the member function LinelJp. The member function LineUp 
instantiates a CActionEvent object sets a pointer to the 
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member function LineUp. and invokes the member func^on 
InfonnTargets of the connection manages*. Hie member 
function LineUp then invokes the member function value 
passing a new value for the scroll bar. 

The member function value receives the new value. If the ^ 
new value is different than the current value, then the 
member function adjusts the slider, instantiates a CIntEvent 
object sets the event object to the new value, sets a pointer 
to the member function value (to identify the source member 
function), and invokes the member function InfonnTargets 
of the connection manager. 

The member function Tninimum illustrates a member 
function of an object that does not cause a message to be sent 
to target objects, that is, it does not correspond to an ou^ut ^ ^ 
port. The member function minimum, however, may corre- 
spond to an istpux port. In one embodiment, a memba 
function could correspond to both an input and an output 
port (a bidirectional port). The member function can be 
invoked to receive a message and then send a message to 
other target objects. 

In a preferred embodiment, the present invention is imple- 
mented to execute under the Windows operating system 
developed by Microsoft Ccqxaration. The Windows operat- 
ing system is described in "Programming Windows" written 25 
by Charles Petzoid and published by Microsoft Corporation, 
which is haeby incorporated by reference. 



Code TABLE 3 



35 



style, 
posJefl, 

posiighl - posJeft, 



43 



class CScroUbar CObjcct, CWindow 
{ 

INT m_JaigeChangc; 

INT m qnali r iiaT^ .' 

INT nL_vahie; 

INT minimum; 

INT n^_marTin it' n i; 

BOOL m^isVcrt; 

CSaoUBaiO; 

CScrollBai^const VRect &pos, CWindow ♦parcat, bool- 
ean isVeit); 
virtual INT lar^eCbangeO; 

virtual VOID largeChapgc(INT); 40 
virtual INT smallChangeO; 
virtual VOID siiuIIChazi£e(INT); 
TOtualINT vahieO; 
virtual VOID vahie(INT); 
virtual INT minimumO; 
virtual VOID minimum(INT); 
virtual INT maximumO; 
virtual VOID maxinimn(INT); 
virtual VOID lireUPO; 
virtual VOID liocDownO; 
virtual VOID pagcUPQ; 
virtual VOID pageDowuO; 

virtual LONG HaiidkPaienflllsg(HWND hwnd, unsigned wm» WORD 50 
wParam, LONG 
IParam); 

} 

CScrollBar:CScn>liBar(coast VRECT &pos, CWindow »paient, BOOL 
isVert) 

DWORD style; 55 
if (isVtrt) 

style = WS_CHILD I SBS.VEiO'; 
else 

style = WS_CHILD I SBS_JiORZ; 
ni_is\fert = isVert; 
CWin^Sndov:±iit( parent, 

KULL, 

OU 

"SCROLLBAR", 



60 



65 
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Code TABLE 3-continued 



smaUChaQge(l); 
taigeChan£e(10); 
minimuinp); 
axaxiinuni( LOO); 
valne(0); 

} 

VOID CScrollBaniliaeUpO 



pos-bottom - pos-top, 

NULL, 

NULL); 



{ 



CActionEvent cvt; 

VOID (SciollBar.:*m^X) = &CScroUBar.lineUp; 
lafiormTaisetC&evt, Me£abeTTd.on£(mfp)); 
vahie(m^value^n_smalIChaqge); 

} 

VOID CScroUBarr^alueONT theVOuc) 



{ 



20 



ifj[theV^ue < m Tmnhmnn 

the Value = n^miniimmi 
i^tbeVUue > m maT jininn 

the Value = tt^ marimnm 

if (ni_valuc 1= theWue) 
{ 

m_value = theValoe; 
if (m_hwiKl 1= NULL) 

SetScronPos(GctHwndO, SB_CIU nL_vahie, TRUE); 
Clnt Value nuoEvent; 

INT (CSciollBan:»ni^)0 = &CScrollBar:vahie; 
numEvcnLnumVahic = in_value; 

InfonnTaigetsC&nuinEveDt, (ULONG)MembeiToLong(m^)); 



} 



} 



30 VOID CScn)UBar:ininimun](INT tbeMinimum) 



m mintTTmm = thftMininP'Tn 

if (nL-hwnd != NULL) 
SetScrollRange(GctHwndO, SB_CTL, m^jnimmum, nx_jnaxin]um, 
TRUE); 

if ( m < the Minimuni) 
vahic(tbeMiiunii2m) ; 

} 

LONG SctolIBaniHaiidleParentMsjC HWND hwxKl, 

WORD wparam, 
LONG IParam) 



{ 



switch(wm) 
{ 

case WM^HSCROLL: 
case WM-_VSCROLL: 
switch(wParam) 



{ 



lineUpQ; break; 
lineDownO; bxcak; 
pageUpO; break; 
pa^eDownO; break; 
vahje(niimniuaiO); break; 
value(ixiaxizmmiO): break; 



} 



case SB_|JNEUP: 
case SB_LINEDOWN: 
case SB_J»AGEUP: 
case SB_PAGEDOWN: 
case SB_TOP: 
case SB_JBOTrOM 
case SB_TRACK: 
case SBL-THUMBPOSmON vahie(LOWORDXlP«am)); 
bxak; 

case SB_ENDSCROIi: break; 

) 

default break; 

} 

letum CWinWindow::HandkParen:MSG(bwndl, win, vpaiam, IPaiam); 



In a prefened embodiment, the programming system 
persistently stores the nm-time objects of a visual program. 
The programming system mainTAing a pointer to each run- 
time object corresponding to a conq>onent To store the 
program, the programming environment invokes a member 
function Serialize (provided by the connection manager of 
eadi object). Hie member function Serialize writes the 
connection array to the persistent storage and invokes the 
member function ScrializeObjectData to write the object 
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Specific data to the persistent storage. The member functioo 
SedalizeObjectData of the comiection manager would typi- 
cally be overridden by the run-time object corresponding to 
the con^ranent For example, the member function Serial- 
izeObjectData for the sctoU bar object writes each data 5 
member to persistent storage. Similarly, each object has 
corresponding member functions to retrieve the persistent 
stored data. When storing and retrieving data, the program- 
ming system needs to map tiie memory address of each 
pointer to its persistently stored object data. When the object lo 
data is retrieved, the pointers in the connection array need to 
be mapped to their new memory locations. 

In a pief^ed embodiment, each component has a corre- 
sponding editor object which controls the placement, 
movement, and connection to the conqx)nent. A standard 15 
interface (CEditor) to the editor object is provided. The 
CEditor object provides a standard mechanism (1) for dis- 
playing the available ports and the current connections, (2) 
for selecting an available port (3) for connecting a port to 
another port and (4) for moving the component. Hie imple- 20 
mentor of a component preferably implements an editor 
object that inherits the CEditor interface. When a program- 
mer selects a component die programming system instan- 
tiates both the run-time object and an editor object for the 
component. 25 

FIG. 8 is a block diagram of data structures of a CEditor 
object The CEditor object 802 contains a pointer to a list of 
available ports (mPortUst). a pointer to a user interface 
editor object (mEditorUI), a pointer to the run-time object 
corresponding to fee component (mSubject), a pointer to a 30 
list of child editor object (mChildEditors). and a pointer to 
a parent editor (mParent). Each port is described by a 
CEditPort object 808. A CEditPort object contains a pointer 
to the associated CEditor object (mOwnerEditor), a pointer 
to a list of input ports to whidi the port is connected 35 
(mConnectedPorts), status information (mStatus), and 
pointo- to member functions identifying the input and output 
portions of the port (mValueIn and mValueOut) as pointers 
to member functions. The CEditorUI object 812 contains 
member functions to control moving the conc^nent on the 40 
display and displaying available ports and connections. 

A component may contains child components. For 
example, a window component (parent component) may 
contain a scroll bar component The CEditor object for tiie 
window contains pointers to each child CEditor object 45 

The visual programming environment tracks the first level 
of parent components. Each CEditor object tracks its child 
CEditor objects. When an event occurs (e.g. mouse button 
down), the prograimning environment passes the event to 
the appropriate first level component The first level com- so 
ponent is responsible to passing the event on the appropriate 
diild component 

Code Table 4 is pseudocode for the dass CEditor. The 
CEditer class inherits the CObject dass. This inheritance 
allows connections between CEditor objects to be controlled 55 
by the connection manager. The CEditor objects are, thus, 
connected in a manner similar to the way the run-time 
objects are connected. The CEditor obje<l includes a con- 
structor and member function to delete an object. 

60 

Code TABLE 4 

class CEditor public COlgect 
{ 

public: 

CEdilOEi<CEditar* pEditoi^ COlyeci* pSutgect); 65 
virtual VOID ObiectDclcted(CObject» object); 
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Code TABLE 4-continued 



virtual VOID PortCSiangedCCEditftjit* port); 
VStri^g mName; 
private: 

CEditParlListPtr mlVirfList; 
CEcfitorUIPtr mEditorUI; 
CObjectPtr mSubject; 
CEditorLisPtr mChildEdiiors; 
CE(£tof{^ mParent; 

}; 

VOID CEditoi:K)bjectDeletedCCObject« object) 



for each CEdhPoit poitl in mPoitList 
if (portl is cosnuted) 
far each CEditPort poit2 in mConncctedft)rts of poitl 
if (part2jiiSubject = object) 
portl->Disconnect(port2) 
Reinove'aiget(Gb)ect); 
xnSubject->Ren]aveTaiget(object); 
for each CEditorUI eui in mEcfitorUIList 
cui->Rai»veTaiget(object); 



Code Table 5 contains pseudocode defining CEditorUI 
class. The CEditorUI dass provides a standard mechanism 
for editing connections between components and movement 
of components. When a programmer selects to add a com- 
ponent to a visual program, the programming system instan- 
tiates the object, an CEditorUI for the object, and a CEditor 
object for the object In a preferred embodiment, the pro- 
granmier can move a component by dicldng on the com- 
ponent A tracker box is drawn and the user can then drag the 
component to a new position. 



Code TABLE 5 



class CEtfitorUI: public CObject, CWiiKiow 

public: 
virtual void 
virtual BOOL 
virtual BOOL 
virtual BOOL 
virtual void 
BOOL diowTVacker, 
VPoint startSize; 
VPoint startPoint; 
WORD dragMode, 
virtual BOOL 
virtual BOOL 



Draw(canst VRect& rectUpdate); 
OnMouseStart(CUsaEvp ». VPoint. INT, INT); 
OnMouscI>rag(CUserEvp *, Vpoint, BOOL); 
OnMouseEndCCUsaEvp *, VPtrint, BOOL); 
PositianChai^geO; 



CPopMcnuPtr 
CPiopcrtyDiatotgPtr 
private: 
CEditDrf>tr 
BOOL 

}; 



MakeStdUI(CEdjtor*, CWindow*); 
Noti^vcnt(CEvcnt* cv, 
CObject* sender, 
ULONG acdon>, 
ni.^p<^»up; 
m_dialotg; 

iu£(£itQr; 
mIsActive; 



The programming system invokes the member function 
Draw to request the component to draw a tracker box. The 
programming system invokes the member function 
OnMouseStart to indicate that object is being selected, the 
member function OnMouseDrag to indicate tiie new position 
of the tracker, and the member function OnMouse^d to 
indicate that the tracking is complete. The member function 
OnMouseEnd invokes the memba- function PositionChange 
to pass the new position to the CEditorUI object that is 
spediic to the con^onent (e.g., scroll bar). 

The member funrtion MakeStdUI initializes a standard 
user interface for the conq>onent The standard user interface 
indudes a menu for selecting to delete the coixqKsnent to 
move or size the com$>onent, or to change properties of the 
component The CEditorUI provides a standard dialog for 
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displaying available ports and cuirent connections. For 
example, a list of available ports would be 



Name 


Type 


Input Member 


Output Member 


PoshioD 


ClQtEvent 


6 


7 


PageUp 


CActkinEvcnt 


a 


12 



Code Table 6 contains pseudocode describing the CBdit- 
Port class. This class provides member functions to manage 
die actual connection between components. When two ports 
are selected for connection, the progranmiing system 
invokes the member function Connect of the output port 
passing the input port The member function Connect adds 
the target object to the connection acray of the source object 
and adds the input port to the list of connections for die 
editor object. 



Code TABLE 6 



class CEditPoit public CObject 
{ 

public: 

virtual BOOL 

virtual BOOL 
private: 

VString 

CEditorPtr 

CObjcctPir 



CEditpQitListPtr mConoectedPorts; 



Ccmnect(CEditPart* OtheiPort); 
Disconiicct(CEditPart* OtheiPort); 

mName, 
mOwne^ditor, 
mSubject; 



BOOL 
BOOL 
BOOL 
BOOL 
BOOL 
CObjectPtr 
CObjectPtr 



mlsConnected: I; 
mIsOulput: 1; 
mlslnput 1; 
iDCaoRcad: 1; 
mCanWiite: 1; 
mWueItt 
mWueOut; 



}; 

BOOL CEditfV3rt::Cooiiect(CEditPort* OtherPort) 



{ 



OtePort->mSubject, 



mSubject- 
>Adcrraiget( 

OthcrfOrt->MWiieOut); 
mlsConnected = TRUE; 
mConDectedPQrts->Add(OtheipDrt); 
retora TOUE; 

} 



Code TABLE 7 



class CEScxoUBar CE£Jor 
{CEScroIIBai(CEditor* pParcntEdilor, 

CWiiKtow* jPaicntWodow 

CObject* pSubject); 

}; 

CEScrolIBar:CEScioIIBai(CEditDr* pParentEdiiDr, 
CWindow* pParenlWiadow, 
COfcgect, psiubject) 
:CEdiiat(ifartxi£ditDx; pSubject) 



{ 

CEditPoit* pp; 

vo«l (CSciollBar.:*mfy3)0; 
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Code TABLE 7-continued 
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15 



{ 

INT (CScroIIBan:*m^l)0 = ACSooIIBann^; 
void {CScroIlBar:*m^)(INT) = fiCSaoUBanrvahie; 
pp = new CN«mF.ditPDTt(thi5, *^Wue"); 
pp->isOuiput(TRXJE); 

pp^ahieOut((CObj<«t*)McmbcrToLong(ixifpl)); 
pp->isIiq»utfni.UE); 

pp->vaIuelE((CObject*)McmbcrTQLoQg(in^2)); 

pp->canRead(TRUE); 

pp->canWntaCrRUE); 

pQrtListO->Add(pp); 

} 

pp = new CEditPort(&is, "Line Up"); 
pp->isIiqnit(rRUE); 

pp->valuelQ((C0biect*)MembeilbLong(m^3 = &CSczolIBar:lizieUp)); 
pQrtListO->Add(pp); 

CEScioIlBarUI* m = new CEScrolIBarUI(this, pParentWindow); 

cditorUIUst(new GEditorUIUst); 

editQrUIList(>>Add(ui); 

} 



20 



25 



30 



Code TABLE 8 



class CEScrollBaiUtCEditorUI 
{CEScrolIBaiUI(CEcUtor*,CWiiKkw*)} 
CEScrolIBarULCESaolIBarUI( CEditot* t££tor, 

CTWodow* ii>arentWindow) 



{ 



} 



editor(p£ditor); 
paienl(pParentWindow); 
CObject*po = cditorO->subjectC); 
position( ((CWindow*)po>- >positk3nO ); 
MakeStdUI(pEditor, pParentWnckw); 



Code Table 7 contains pseudocode fcH* an implementation 
of the CEditor class for a scroll bar component. The imple- 
mentation provides a constructor for the CESaollBar class 
that inherits the CEditor class. The ConstnictGr instantiates 
a CEditPoft object for each port for the scroll bar coixq>o- 
nent In this example, the ports are **value" and **LineUp." 
Hie port value is a bidirectional port, that is. the member 
function value can be conne<^d to an input and ou^ut port. 
The constructor also creates a CEScrollBarXJI object Code 
Table 8 contains pseudocode for the EScroUBarUI class. 



FIG. 9 is a block diagram illustrating a computer system 
35 for implementing the present invention. The computer sys- 
tem 901 includes central processing unit 902. memory 903, 
storage 904, display 905, and input device 906. In a pre- 
ferred embodiment, objects are instantiated in memory and 
persistently stored to stcarage. Visual programs output data to 
40 the display and input data from the ii^ut device. 

Although the present has been described in terms of a 
preferred embodiment it is not intended that the invention 
be . limited to this embodiment Modifications within the 
spirit of the invention will be qiparent to those skilled in the 
45 art The scope of the present invention is defined by the 
claims whidi follow. 
I daim: 

1. A method in a computer system for conqx>sing a visual 
program, the method conqjrising the steps of: 
so when selecting each of a plurality of components to be 
included in the visual program, instantiating a run-time 
object to implement the behavior of each selected 
con^nent and instantiating an editor object for each 
selected component; and 
ss under control of the instantiated editor object for a 
component. 

displaying a list of available ports for the instantiated- 
lun-time object that in^lemcnts the behavior of the 
component each available port cciresponding to an 
60 event associated with the con^nent; 

selecting a displayed port; and 

directing the instantiated lun-time object that in^le- 
ments the behavior of the camponent to establish a 
connection between the selected pc^ and a targ^ 
65 object whereby during execution of the visual pro- 

gram the instantiated run-time object that imple- 
ments the behavior of the component sends an indi- 
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cation of the event to each target object connected to 
the port upon occuirence of the event 

2. The method of daim 1 wherein the editor objects 
control displaying a visual representation of the components 
during composition of the visual program. 5 

3. The method of claim 1 wherein the nin-time objects 
control displaying a visual rqiresentation of each of the 
components during composition of the visual program and 
the editor objects control positioning of the visual represen- 
tation. 10 

4. The method of daim 1 wherein each nm-time object 
inherits a manager class having membo- functions for estab- 
lishing the connection, wherein the editor objects invoke the 
member function to store in the run-time objects an indica- 
tion of the connection. 15 

5. The method of claim 1 wherein each poit is a member 
function of the source object 

6. The method of daim 1 wherein the editor objects 
inherit a managing editor class for controlling the establish- 
ment of the connection. 20 

7. The method of daim 1 wherein each editor objects 
contain a reference to an editor user interface object for 
controlling interactions with a programmer of the visual 
program. 

8. The method of claim 1 wherein each component 25 
contains a plurality of sub-components and the editor objects 
contain a reference to each editor object corresponding to a 
sub-component 

9. A conq}uter-readable medium containing instructions 
for composing a visual program by: 
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when sdecting each of a plurality of components to be 
included in the visual program, instantiating a run-time 
object to implement the bdiavior of each sdected 
component and instantiating an editor object for eadi 
sdected component; 

under control of the instantiated editor object for a 
component 

displaying a list of available ports for the instantiated 
run-time object that in5)lements the behavior of the 
(X)mponent each available port corresponding to an 
event assodated with the component; 

sdecting a displayed port; and 

directing the instantiated run-time object that iiiq)le- 
ments the behavior of &e component to establish a 
connection between the sdected port and a targ^ 
object whereby dming exec^on cf the visual pro- 
gram the instantiated run-time object that imple- 
ments the behavior of the conq>onent sends an indi- 
cation of the event to each target object connected to 
the port upon occurrence of the event 

10. The computer-readable medium of daim 9 wherein 
the editor objects control displaying a visual representation 
of the cx)mponents during composition of the visual pro- 
gram. 

11. The conqjuter-readable medium of claim 9 wherein 
the run-time objects control displaying a visual representa- 
tion of each of the components during composition of the 
visual program and the editor objects control positioning of 
the visual representation. 

***** 
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